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INTRODUCTION 


This document is intended to serve as a quick reference 
and convenient memory aid for the user with some familiarity 
with Multics command conventions, 

This guide presents an abbreviated description of the 
Multics commands and active functions described in detail in 
the Multics Programmers’ Manual Commands and Active 
Functions (MPM Commands), Order No. AG92. The com- 
mands are presented in alphabetical order, with each descrip- 
tion showing the proper usage and a list of the control 
arguments and optional arguments that may be used. Control 
arguments are only listed; they are not defined in detail in 
this document. . 

The reader is expected to be familiar with the Multics 
command environment conventions. The following terms are 
defined here and are not explained at each occurrence in this 
document. If the reader needs more information on termi- 
nology than is given here, he should refer to “‘Glossary of - 
Multics Terms” in Section I of the Multics Programmer’s 
Manual Reference Guide, Order No. AG91. 


ACL access control list; it describes who may access 
an entry in the Multics storage system and in 


what way (see modes below). 


modes access identifiers; used to define the kind of 
access a user has to a storage system entry. The 
modes are: 
segments directories 
r (read) s (status) 
e (execute) m (modify) 
w (write) - a (append) 


Null access can also be specified for either seg- 
ments or directories: “”’, n, or null. 

path pathname of an entry; it can be relative or 
absolute. 

Person_id __user’s registered personal identifier; usually 
some form of the user’s surname; unique at 
site. 


Project_id 


User_ id 


user’s registered project identifier; a project is 
an arbitrary set of users grouped together for 
accounting and access control purposes. 
access control name of the form Person _ id. 
Project_id.tag; since the tag portion is rarely 
explicitly given, the term User_ id is often de- 
fined as a Person_id.Project_id pair. 


COMMANDS 


The format of each command description in this docu- 
ment is based on those found in the MPM Commands, The 
command name, in boldface type, is shown first, followed by 
the usage line. In the usage line, the following conventions 


apply: 
1. 


To 


If a command accepts more than one of a specific 
argument, an “‘s” is added to the argument name 
(e.g., paths, control_ args). 

To indicate one of a group of similar arguments, an 
“4”? is added to the argument name (e.g., pathi, 


control_argi). 


. Multiple arguments that must be given in pairs are 


indicated by xxxl yyyl... xxxnyyyn. 
Pathnames that must be given in pairs are indicated by 
pathij path21...pathin path2n. 


- Optional arguments are enclosed in braces (e.g., 


{ path }, {- control_args b. All other arguments are 
required. 


illustrate these conventions, consider the following 


usage line: 


command { paths } {— control_args } 


The lines below are just a few examples of valid invocations 


of this 


command: 


command 

command path 

command path path —control_arg 
command path —control_arg —control_arg 
command —control_arg 

command —control_arg —control_arg 


For simplicity, when an argument takes a value other 


than a pathname (indicated by “‘path’’), the value is indicated 
as follows: 

XX character string 

N number, decimal or octal 

DT date-time character string in a form acceptable 


to the convert_date_to_binary_ subroutine 
described in the Multics Programmers’ Manual 
Subroutines, Order No. AG93. 


If more information is needed about a particular value, 
the reader should consult the appropriate command descrip- 
tion in the MPM Commands. 

The commands listed below are grouped according to 
their function. An abbreviated description for each com- 
mand is given in the following pages, arranged in alphabetical 
rather than function order. 


Access to the System 


(preaccess requests) 


MAP 

963 

029 
dial 
enter 
enterp 
login 
logout 


Creating and Editing Segments 


adjust_bit_count 
basic_system 
compare_ascii 
edm 

indent 

program _interrupt 
qedx 

runoff 
runoff_abs 

set_ bit_count 
sort_seg 


Segment Manipulation 


adjust__ bit_ count 
archive 
compare 
compare _ ascii 
copy 

create 

delete 

delete force 
link 

move 
set_bit_count 
sort_ seg 
truncate 
unlink 
vfile_ adjust 


Directory Manipulation 
add_ name 
create_ dir 
delete_ dir 
delete name 
fs_chname 
link 
list 
rename 
safety_sw_off 
safety_ sw_on 
status 
unlink 
vfile_ status 


Access Control 
delete_acl 
delete_iacl_dir 
delete_iacl_seg 
list_ acl 
list_iacl_ dir 
list_ iacl_seg 
set_ acl 
set_iacl. dir 
set_iacl_seg 


Address Space Control 
add_search_ rules 
change_default_wdir 
change_wdir 
delete_search_rules 
initiate 

list_ ref_names 
new_ proc 
print_default_ wdir 
print_proc_auth 
print_search_ rules 
print_wdir 
set_search_rules 
terminate 
terminate_refname 
terminate_segno 


terminate_single_refname 


where 


Formatted Output Facilities 
cancel_daemon_ request 
dprint 
dpunch 
dump_ segment 
list_ daemon_ requests 
print 
runoff 
runoff_abs 


Language Translators, 


Compilers, Assemblers, 
and Interpreters 
apl 
basic 
basic_ system 
bind 
cancel_cobol_ program 
cobol 
display_cobol_run_unit 
format_cobol_ source 
fortran 
fortran_abs 
indent 
pli 
pli_abs 
profile 
qedx 
run_cobol 
runoff 
runoff_abs 
set_cc 
stop_cobol_run 


Object Segment 
Manipulation 


archive 
bind 


Debugging and Perform- 
ance Monitoring Facilities 


change_error_ mode 
cumulative_page_ trace 
debug 

display_ pllio_error 
dump_ segment 
page_ trace 

probe 

profile 

progress 

ready 

ready_ off 
ready_on 
reprint _ error 

trace 

trace_ stack 


Input/Output System Control 


assign_ resource 
cancel_ daemon_ request 
close _ file 

console_ output 
copy_ cards 
display_ pllio_error 
dprint 

dpunch 

file_ output 

io_ call 

line_length 


' list_daemon_ requests 


list_ resources 

print 

print_attach_ table 
print_request_ types 
set_cc 

set_ tty 

unassign_ resource 
vfile_ adjust 

vfile_ status 


abbrev 
add_search_rules 
answer 

basic_ system 
change_default_ wdir 
change _error_mode 
change_wdir 
console_ output 
delete_search_ rules 
do 

exec_com 

file_ output 
get_com_line 

line_ length 

memo 

new_ proc 
print_default_ wdir 
print_search_ rules 
print_wdir 
program_ interrupt 
ready 

teady_ off 
ready_on 

release 

reprint_ error 
set_com_line 
set_search_rules 
Stari 


Communication Among 
Users 


accept_ messages 
defer_ messages 
immediate_ messages 
mail 
print_auth_names 
print_ messages 
send_ message 

who 


Command Level Environment Communication with the 


System 
check_info_ segs 
help 
how_ many _users 
print_motd 
who 


Accounting 
get_ quota 
move_ quota 
resource_ usage 


Control of Absentee 
Computations 
cancel. abs_ request 
enter_abs_ request 
fortran_abs 
how_many_users 
list_ abs_ requests 
pll_abs 
runoff_abs 
who 


GCOS Environment 
gcos 
gcos_card_ utility 
gcos_ sysprint 
gcos_syspunch 


Miscellaneous Tools 
calc 
decode 
encode 
memo 
progress 
walk _ subtree 


abbrev, ab 
provides the user with a mechanism for abbreviating 
parts of (or whole) command lines in the normal com- 
mand environment. 


Usage: abbrev 


CONTROL REQUESTS 

.a <abbr> <rest of line> 
add the abbreviation <abbr> to the current profile 
segment, 

.ab<abbr> <rest of line> 
add an abbreviation that is expanded only if found 
at the beginning of a line or directly following a 
semicolon (;) in the expanded line. 

.af <abbr> <rest of line> 
add an abbreviation to the profile segment and 
force it to overwrite any previous abbreviation with 
the same name. 

.abf <abbr> <rest of line> 
add an abbreviation that is expanded only at the 
beginning of a line and force it to replace any pre- 
vious abbreviation with the same name. 

dd <abbrl]>...<abbrm> 
delete the specified abbreviations from the current 
profile. 


enter a mode (the default mode) that forgets each 
command line after executing it. 
1 <abbri>...<abbrn> 
list the specified abbreviations with the things they 
stand for. 
<ietter]>...<lettern> 
list all abbreviations starting with the specified 
letters. 


wl 


po 


quit using the abbrev processor. 


enter a mode that remembers the last line expanded 
by abbrev. 

.s <rest of line> 
show the user how <rest of line> would be ex- 
panded but do not execute it. 
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su <profile> 
specify to abbrev the pathname of a profile seg- 
ment to use. 
-—p : 
print the name of the profile segment being used. 
.<space> <rest of line> 
pass <rest of line> on to the current command 
processor without expanding it. 


BREAK CHARACTERS 
Break characters (any combinations) must be used to 
delimit abbreviations in a command line. 


tab semicolon : 
newline vertical bar | 
space parentheses () 
quote * less than < 
dollar sigzn $ greater than > 
apostrophe ” brackets { ] 
grave accent ‘ braces { } 
period ‘ 


accept_messages, am 
initializes or reinitializes the user’s process for accept- 
ing messages sent by the send_ message command. 


Usage: am { —control_args } 


—brief, —bf 
—long 
—print 
—short 
add_name, an 
adds an alternate name to the existing name(s) of an 
entry. 


Usage: an path names 


names 
additional names to be added to the entry. 


add_ search rules, asr 


allows the user to change his search rules dynamically. 


Usage: asr path11 { —control_arg path2]}.. 
. pathin { —control_arg path2n 


pathli 
pathname of a directory to the current search 
rules (certain keywords may also be used). 
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control_arg 
—before 
~—after 


path2i 
pathname representing current search rule 
(certain keywords may also be used). 


adjust_bit_count, abc 
sets the bit count of segments that for some reason do 
not have the bit count set properly. 


Usage: adjust_bit_count paths { —control_args } 
—character, —ch 


—long, —lg 


answer 


provides a preset answer to a question asked by 
another command. 


Usage: answerans {-—control_ args } command _line 


ans 
desired answer to any question. 


command _line 
any Multics command line. 


control_args 


—brief, —bf 
—times N 
apl 
invokes the Multics APL interpreter. 
Usage: pl 


archive, ac 
combines an arbitrary number of separate segments 
into one single segment. 
Usage: archive key path components 
components 
components of the archive segment. 
key 
listed below by function. 
Table of Contents Operations: 
t print the entire table of contents if no 


components are named by the path 
arguments, 


10 


tl 
tb 
tlb 


print the table of contents in long form. 
print the table of contents, briefly. 
print the table of contents in long form, 
briefly. 


Append Operations: 


a 


ad 
adf 
ca 
cad 
cadf 


append named components to the ar- 
chive segment. 

append and delete. 

append and deleteforce. 

copy and append. 

copy, append, and delete. 

copy, append, and deleteforce. 


Replace Operations: 


r 


rd 
rdf 
cr 
crd 
crdf 


replace components in, or add com- 
ponents to the archive segment. 
replace and delete. 

replace and deleteforce. 

copy and replace. 

copy, replace, and delete. 

copy, replace, and deleteforce. 


Update Operations: 


cud 


cudf 


update. 

update and delete. 

update and deleteforce. 

copy and update. 

copy, update, and delete. 
copy, update, and deleteforce. 


Delete Operations: 


d 


cd 


delete from the archive those components 
named by the path arguments. 
copy and delete. 


Extract Operations: 


disk reader 
console special 
printer 

control_ args 
—comment XX, —com XX 
—density N, —den N 
—device XX, —dv XX 
—line_length N, —l1N 
—long, —lg 
—model N 
—system, —sys 
—track N, —tk N 
—train N, —tn N 
—volume XX, —vol XX 


basic 
invokes the BASIC compiler. 
Usage: basic path {—control_arg } 


—compile 
—tine N 


basic_system, bs 
standard BASIC source editor and run dispatcher. 


Usage: basic_system {path} 


REQUESTS 
delete ali 
Or 
delete first {last } 
deletes the specified lines. 


exec command _line 
passes the command_line argument to the Multics 
command processor. 


get { path } 


X extract from the archive those com- 
ponents named by the path arguments, clears the internal buffers so that the user can work 
placing them in segments in the storage ona different program. 
system line_ number 
xf extract and deleteforce. deletes that source line if such a line number exists. 
assign__resource, ar line_ number source _line 
calls the resource control package (RCP) to assign a adds or replaces a BASIC source line (source_line) 
resource to the caller’s process, in proper sequence, 
Usage: assign_resource type { —control_args } list 
type prints the entire current internal segment. 
tape punch 
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quit 
exits from basic_system and returns to command 
level. 


rseq { first } { increment } 


resequences the line numbers so that they differ by 


a fixed increment. 


run 
calls the BASIC compiler to run the current 
internal source segment. 


save { path } 
stores the current internal source segment in the 
segment whose pathname is specified by path. 


time N 
establishes a time limit of N CPU seconds on the 
execution of the program. 


bind, bd 
produces a single bound object segment from one or 
more unbound object segments. 


Usage: bind paths {—control_arg } 
—list, —Is 


—map 
—update paths, —ud paths 


calc 
provides the user with a calculator. 
Usage: calc 
REQUESTS 
< expression > type value of 


expression. 
< variable >= <expression > assign value of ex- 


pression to variable. 


list list variables. 
q return to command 
level, 
EXPRESSIONS 


order of evaluation 
1. expression within parentheses 
2. function references 


13 


3.. prefix +, prefix — 
4, ** 
Se Pgh 
6. +,- 
FUNCTIONS. 
sin, cos, tan, atan, abs, In, log 


cancel__abs_request, car 
allows a user to delete a request for an absentee 
computation. 
Usage: cancel_abs_request path {—control_args } 
—all, —a 
—brief, —bf 
—queue N, ~q N 


cancel_cobol_program, ccp 
cancels one or more programs in the current COBOL 
run unit. 

Usage: cancel_cobol_ program names { —control_arg } 


control_arg 
—retain_ data, —retd 


names 
name specified in the PROG-ID statement. 


cancel_daemon_request, cdr 
cancels a dprint or dpunch request. 
Usage: cancel_daemon_ request path { —control_args } 
—all, —a 
—brief, —bf 
—queue N, —q N 
—request_type XX, —rqt XX 


change_default_wdir, cdwd 
sets a specified directory as the user’s default working 
directory for the duration of the current process or 
until the next change_default_ wdir command is 
issued. 


Usage: change_default_wdir { path } 
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change_error_mode, cem 
controls the amount of information printed by the de- 
fault handler for system conditions. 

Usage: change_error_mode {-—control_args } 


—brief, —bf 
—long, —lg 


change_wdir 
changes the user’s working directory to the directory 
specified as an argument. 


Usage: change_wdir {path } 


check_info_ segs, cis 
prints a list of new or modified segments. 
Usage: check_info_segs {-—control_args } 


—brief, —bf 

—call command _line 

—date DT, —dt DT 

—long, —lg 

—no_update, —nud 

—pathname star_name_path, —pn star_name_path 


close_file, cf . 
closes specified FORTRAN and PL/I files. 


Usage: close_file {—control_arg } filenames 


control_ arg 
—all 


filenames 
names of the open files. 


cobol 
invokes the COBOL compiler. 


Usage: cobol path {-—control_args } 


—brief, —bf —~severityN, —svN 
—check, —ck —source, —sc 
—debug, —db --symbols, —sb 
—format, —fmt —table, —tb 
—list, —Is —time, —tm 
—map 
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compare 
compares two segments and lists their differences. 


Usage: compare path! { loffset1 } path2 { loffset2 } 
—control_args 


pathi, path2 
pathnames of segments to be compared. 


offsetl, offset2 


octal offsets within the segments to be compared. 


control_ args 
—length N, —In N 
—mask N 


compare _ ascii, cpa 

compares two ASCII segments and prints the changes 

made to the segment specified by path1 to yield the 

segment path2. 
Usage: compare_ascii path! path2 { minchars } 

{ mintlines 
path], path2 
pathnames of segments to be compared. 


minchars 
decimal number specifying the minimum num- 
ber of characters that must be identical before 
the segments are again assumed to be “‘in sync” 
after a difference in the two segments. 
minlines 
decimal number specifying the minimum num- 
ber of lines that must be identical. 


console_ output, co 
directs the user_output to the terminal, (See 
file_ output.) 


Usage: console_output 


copy, cp 
creates copies of specified segments and/or multiseg- 
ment files in the specified directories with the speci- 
fied names. 


Usage: copy pathi] {path21}...pathin {path2n} 
—control_args 
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pathli 
pathname of segment to be copied. 


path2i 
pathname of a copy to be created from path1i. 


control_ args 


—acl 

—all, —a 
—brief, —bf 
—name, —nm 


copy _cards 


copies specified card image segments from system 
pool storage into a user’s directory. 


Usage: copy_cardsdeck_name { path } 


deck_ name 
name entered on deck_ id card. 


create, cr 
creates a storage system segment in a specified direc- 


tory (or in the working directory). 


Usage: create paths 


create_dir, cd . 
creates a specified storage system directory branch in 4 
specified directory (or in the working directory). 


Usage: create_dir paths {—control_args } 


—access_ class XX, —acc XX 
—quota N 


cumulative_page_trace, cpt 
accumulates page trace data so that the total set of 
pages used during the invocation of a command or sub- 


system can be determined. 


Usage: cumulative_page_ trace command _line 
{ —control_args } 


command _line 
character string to be interpreted as a command 


line. 


control_args 
—count, —ct —reset, —rs 
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—flush —short, —sh 


—interrupt N, —int N —sleep N 
—long, —lg —timers 
—loop N —total, —tt 
—print, —pr — trace path 
debug, db 
interactive debugging aid to be used in the Multics 
environment. 


Usage: debug 


DATA REQUESTS 
Format of Data Request 
<generalized address> <operator> < operands > 


Generalized Address 
[/segment name/ ] [offset] [segment ID] 
[relative offset] 


/seg name/ offset segment ID 
pathname number &t text 
ref name symbol &s Stack 
seg number &l linkage 
&n seg name &an source line 
seg $entry &pn parameter 
&i internal static 
rel offset 
number 
register 
Operators Operands Output Modes 
2 print operands ° octal 
= assign input list h_half-carriage octal 
< set break function d decimal 
> transfer list a ASCII 
:= call i instruction 
P pointer 
$ source statement 
1 code for line 
number 
n no output 
e floating point 
f floating point 
b_ bit string 
g graphic 
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CONTROL REQUESTS 
Multics command 
aim print argument iin mode m 


(modes: 0, p, d, a, b, 1, e, f, 7) 

-bc alf “=}a2 make conditional all breaks of de- 
fault object segment 

-bei al{= “=ha2 make conditional break i 

.bd name/no. _ set (or print) default object segment 


.be <line> execution line for all breaks of the 
default object segment 

-bei <line> execution line for break i 

-bge <line> execution line for all breaks 

-bgl list all breaks 

.bgn enable all breaks 

.bgo disable all breaks 

-bgr reset all breaks 

-bgt <line > establish a temporary global command 

-b1 list the breaks of the default object 
segment 

bli list break i 

-bn enable the breaks of the default 
object segment 

-bni enable break i 

-bo disable the break of the default 
object segment 

boi disable break i 

.bp print names of all segments with 
breaks 

-br reset the breaks of the default object 
segment 

-bri reset break i 

-bsi n set skips of break i ton 

LC use crawlout registers 

-C,i continue after break fault (ignore 
next 1 break fault) 

Cri continue, in normal mode 

ctl continue, in temporary break mode 

.dor .D print default values 

£ use registers from last fault 

ll set stack to ith frame 

ior .-i pop or push stack by i frames 

.mb change to brief output mode 

-mi change to long output mode 

q return from debug to caller 

.ti,n trace stack from frame i for n frames 
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decode 
reconstructs an original segment from an enciphered 
segment according to a key that need not be stored in 
the system. (See encode.) 


Usage: decode path! { path2 } 


path1 
pathname of enciphered segment. 


path2 
pathname of deciphered segment to be 
produced. 


defer_ messages, dm 
suspends printing of messages sent by the 
send_ message command on the user’s terminal. 


Usage: defer_messages 


delete, dl 
deletes the specified segments and/or multisegment 
files. 


Usage: delete paths 


delete_acl, da 
removes entries from the ACLs of segments, multi- 
segment files, and directories. 
Usage: delete_acl {path } { User_ids } {—control_args } 
—all, -a 
—brief, —bf 
—directory, —dr 
—segment, —sm 


delete_ dir, dd 
deletes the specified directories (and any segments, 
links, and multisegment files they contain). 


Usage: delete_dir paths 


delete_ force, df 
deletes the specified segments or multisegment files, 
regardless of whether or not the safety switch is on. 


Usage: delete_force paths 
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delete_iacl_ dir, did 


deletes entries from a directory initial ACL in a speci- 


fied directory. 


Usage: delete_iacl_dir {path } { User_ids } 
{—control_args } 


—brief, —bf 
—ring N, —rg N 


delete_iacl_seg, dis 


deletes entries from a segment initial ACL in a speci- 


fied directory. 


Usage: delete_iacl_seg { path } { User_ids } 
{—control_args 
—brief, —bf 
—ring N, -rg N 


delete_name, dn 
deletes specified names from entries that have 
multiple names. 


Usage: delete_name paths 
delete_search_ rules, dsr 
allows the user to delete current search rules. 


Usage: delete_search_rules paths 
dial, d 


connects an additional terminal to an existing process. 


Usage: dial dial_id Person_id.Project_id 
dial _id 


keyword that uniquely specifies a logged-in 
process that is accepting dial connections. 


Person_id.Project_id 


the Person_id and Project_id of the process 


the user wishes to connect to. 


display_cobol_run_unit, der 


displays the current state of a COBOL run unit. 


Usage: display_cobol_run_unit {—control_args } 


—all, —a 
—files 
—long, —lg 
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display_ pllio_error, dpe 
describes the most recent file on which a PL/I 1/O 
error was raised and displays diagnostic information 
associated with that type of error. 


Usage: 


do 


display_ pllio_error 


expands a command line according to the arguments 
supplied following the command string. 


Usage: 


do “command _ string” {-control_args } 


command_ string 
a command line in quotes. 


control_args 
a character string argument to replace a param- 
eter designated by &i in command_ string. 


modes 
—absentee 
—brief, —bf 
—go 
—interactive 
—long, —lg 
—nogo 


dprint, dp 


queues specified segments and/or multisegment files 
for printing on the line printer. 


Usage: 


dprint {—control_args } { paths } 


—access_label, —albl ~—no_endpage, —nep 
—bottom_label XX, —no_ label, —nlb! 

—blibl XX —page_length N, 
~brief, —bf —pI N 
—copy N, —cp N —queue N, -—qN 
—delete, —dl ~—request_type XX, 
—destination XX, —ds XX —rqt XX 
—header XX, —he XX —single, —sg 
—indent N, —in N —top_label XX, 
—label XX, —Ib] XX —tlbi XX 
—line_length N, -IN ~— truncate, —tc 
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dpunch, dpn 
queues specified segments and/or multisegment files 
for punching by the card punch. 


Usage: dpunch {—control_args } { paths } 


—brief, —bf —queue N,-qN 
—copy N, -—cpN —raw 

—delete, —dl —request_type XX, 
—destination XX, —ds XX —Iqt XX 

—header XX, —he XX —7Tpunch, —7p 
—mcc 


dump_ segment, ds 


prints, in octal format, selected portions of a segment. 


Usage: dump_segment path { first } { num } 
_— control_ arg 


first 
the octal number of the first word to be 
dumped. 


num 
the octal number of words to be dumped. 


control_ args 


—address, —addr —name, —nm 

—bed —no_ address, —nad 
—block N —no_ header, —nhe 
—character, —ch —no_ offset, —nofs 
—header, —he —offset N, —ofs N 
—long, —lg —short, —sh 


edm 
invokes a simple Multics context editor. 


Usage: edm { path } 


REQUESTS 
enter input mode; exit when a line 


with only “‘.” is typed. 
—N back up N lines, 
enter “comment”? mode; exit when a 


64 99 


line with only “‘.” is typed. 
print current line number, 


b go to bottom of file, enter input 
mode, 
c N /s1/s2/ change all occurrences of string “‘s1” 


to ‘*s2”’ for N lines. 
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dN 
updelete 
E line 


f string 
i line 
merge path 


move MN 


k 


1 string 
nN 
pN 

q 

qf 


r line 

s N /si/s2/ 
t 

y 


w path 
upwrite path 


deletes N lines. 

delete all lines above current line. 
execute “‘line”’ as a Multics com- 
mand line. 

find a line beginning with “string”. 
insert “line” after current line. 

insert segment “‘path”’ after current 
line. 

beginning with line M, remove N 
lines and insert them after the current 
line. 

enter brief mode (no response after f, 
n, 1, c, and s requests). 

locate a line containing “‘string”’. 
move down N lines, 

print N lines, 

exit from edm. 

exit directly from edm with no 
question. 

replace current line with “‘line”’. 
same as “‘c”’, 

go to top of file. 

enter verbose mode (opposite of k 
request). 

write edited copy of file into “path”. 
write all lines above current line into 
“path”, 


encode 
enciphers a segment’s contents according to a key that 
need not be stored in the system. (See decode.) 


Usage: encode path! { path2 } 


pathl 
pathname of segment to be enciphered. 
path2 
pathname of the enciphered segment to be 
produced. 
enter, e 
enterp, ep 


used by anonymous users to gain access to Mulltics. 


Usage: enter { anonymous_name } Project_id 
a control_args } 
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anonymous_ name 


&attach attaches user_ input to 
treated like person identifier. exec_com segment. 
Project_id &detach detaches user_ input. 
identification of the user’s project. &input_line on writes input lines on 
user_ output, 
control_args &input_line off does not write out input lines. 
~brief, —bf &command_line on writes command lines on 
—force ~ 


user_output prior to 
—home_dir path, —hd path 


execution. 
NOR ETCOMD ES TD &command_line off does not write out command 
~—no_print_off, —npf lines. 
—no_ start-up, —ns &ready_on invokes ready message after 
—print_off, —pf a execution of each command 
—process_ overseer path, —po path line. 
enter_abs_request, ear &ready_ off turns off ready message; 
requests that an absentee process be created. weed iseae 
Usage: enter_abs_request path {—control_args } &print char _ string iene ie ring 
—arguments XX, —ag XX &quit returns exec_com to caller. 
—brief, —bf &if [ACTIVE_ FUNCTION —argl .. . —argn —| 
—limit N, iN executes & then clause if 
—output_file path, —of path ; ACTIVE_FUNCTION returns 
—queue N, “true”; executes &else clause 
—restart, —rt if ACTIVE_FUNCTION te- 
—time DT, —tm DT turns “false”; otherwise error. 
exec_com, ec Each argi can also be an active 
executes a series of command lines contained in a nCHOR: 
: &then THEN_CLAUSE 
segment. 


can include a command line, 


Usage: exec_com path { optional_args } input line, null statement, and 


optional_args most control ee 
character strings substituted for &i in the &else ELSE_CLAUSE can include a command line, 
exec_com segment input line, null statement, and 


: es : : most control statements. 
Each &i (where i is an integer) in the exec_com 


segment is replaced by the corresponding argu- 
ment to the exec_com command; &ec_name is 
teplaced by the entryname portion of the 
exec_com pathname without the ec suffix; &0 


file_ output, fo 
directs the user_ output to a segment. (See 
console_ output.) 


is replaced by the path argument to the Usage: file_output { path } 
exec_com command. 
f 
CONTROL STATEMENTS format_cobol_source, fics 
&label location identifies locaiion . converts pseudo free-form COBOL source programs to 
&goto location a er | ie &label the standard fixed-format COBOL source programs. 
specified. Usage: format_cobol_source path] path2 
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path] 
pathname of input segment containing pseudo 
free-form COBOL source code. 


path2 
pathname of output segment containing con- 
verted fixed-format COBOL source. 


fortran, ft 
invokes the FORTRAN compiler. 


Usage: fortran path {—control_args } 


—brief, —bf —optimize, —ot 
—brief_table, —profile, —pf 
—bftb —severityN, —svN 
—card —source, —SCc 
—check, —ck —subscriptrange, —subrg 
—convert symbols, —sb 
—debug, —db —table, —tb 
—list, —Is —time, —tm 
—map 


fortran_abs, fa 
submits an absentee request to perform FORTRAN 
_ compilations. 
Usage: fortran_abs paths {_ft_args } {-dp_args } 
{—abs_ control_args } 
ft_args 
control arguments accepted by the fortran 
command. 
dp_args . 
control arguments (except —delete) accepted 
by the dprint command. 


abs_control_args 
—queue N, -q N 
—hold 
—output_file path, —of path 


fs_chname 


manipulates strangely named segments because none of 


the special command system symbols (e.g., *, >) are 


interpreted. When oldname and newname are not null 


strings, fs_chname is equivalent to using the rename 
command; null string for oldname is equivalent to 
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using the add_ name command; null string for a 
newname is equivalent to using the delete_name 
command. 


Usage: fs_chname dir_name entryname oldname 
newname 


dir_ name 

directory name portion of the segment. 
entryname 

entryname portion of the segment. 
oldname 


old entryname to be deleted. 


newname 
new entryname to be added. 


gcos, gc 
invokes the GCOS environment simulator to run a 
single GCOS job, immediately, in the user’s process. 
Usage: cos job_deck_path {—control_args } 


job_deck_ path 
pathname of segment containing a GCOS job 
deck. 


control_args 
. listed below by function. 
Input Specifications: 
—ascii, —aci —no_canonicalize, —nocan, —no 
—gC08, —gC —truncate, —tc 


Output Specifications: 


—dprint, —dp ~—hold, —hd 
—dprint_options “‘options”’, —list, —ls 

—dpo “options” —lower_case, —Ic 
—dpunch, —dpn —Taw 


—dpunch_ options “options”, 
—dpno “options” 


: Creation of Files: 


—brief, —bf —no_bar, —nobar, —nb 
—continue, —ctu —syot_dir path, —sd path 
—debug, —db —temp_dir path, —td path 
—job_ id id, —id id —userlib 
—long, —lg 
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gcos_card_utility, gcu 
copies GCOS card image files, altering their format, 
content, and medium, as specified by the user. 


Usage: gcu input_ specification output _specification 


input_ specification, output_specification 
pathnames (or tape numbers) and controi argu- 
ments, Control arguments are listed below by 
function. 


Input and Output Specifications: 
—input, —in 
—output, —out 


File Formats: 


—ascii, —aci —no_canonicalize, —no 
—comdk, —cdk —raw 

—gcos_ ascii, —gca —tabs N 

—gcos, —gc —truncate, —tc 


File Contents: 


—imcv XX 
—library XX, —lib XX 


Tape Files: 
—attached, —att —tape7 N 
—detach, —det —tape9 N 
—label XX, —Ib1 XX  —retain, —ret 
—tape N 

Partial Copying: 
—count N, —ct N 
—first N, —ft N 
—last N, —It N 


Output File Duplication: 
—append, —app 
Input and Output Lists: 
—all —list XX, —Is XX 
—file_input path, -fipath, —name, —nm 
—file path 


Terminal Output: 
—brief, —bf 
—debug, —db 
—long, —lg 
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gcos_sysprint, gsp 
converts a print file (either SYSOUT or simulated 
printer) produced by the GCOS environment simu- 
lator, from BCD to ASCII. 
Usage: gcos_sysprint input_ path { output_path } 
{—control_ args } 
input_path 
pathname of a print file produced by the 
simulator. 
output_ path 
pathname into which the ASCII output lines 
are written. 
control_args 
—lower_ case, —lc 
—temp_dir path, —td path 


gcos_syspunch, gspn 
converts a GCOS standard system format file, contain- 
ing BCD and binary card images, to a format suitable 
for punching using the Multics dpunch command with 
the —raw argument. 


Usage: gcos_syspunch path 


get_com_line, gcl 
prints on the user’s terminal the maximum length 
allowed for an expanded command line. 


Usage: get_com_line 


get_ quota, gq 
returns information about the secondary storage 
quota and pages used for a specified directory. 


Usage: get_quota paths {~control_arg } 
—long, —lg 


help 


assists users in obtaining online information about 
such things as commands, subsystems, system status, 
or changes. 


Usage: help {name } {—control_args } 
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name 


the name of an info segment which refers to a 
command or general topic. 


control_args 
—header, —he 
—pathname path, —pn path 
~search XX, —sh XX 
—section XX, —sc XX 
—title 


REQUESTS 


Each info segment is divided into paragraphs delimited 
by double blank lines, After each paragraph, help asks 
More help?” The user may reply: 


yes print next block 

no print no more from this 
segment 

Test rest of this segment 

skip skip next block and 
proceed 

title 


ptint remaining section 
titles, no questions 


quit exit from help 
search { XX}, sh {XX} search forward for string 
XX 


section { XX hse {xx} find section named XX 


how_many_users, hmu 
Prints how many users are currently logged in, 
Usage: how_ many_users { args } {— control_args } 


control_args 
—absentee, —as 
—brief, —bf 
—long, —lg 

args 
Person_id 
-Project_id 
Person_id.Project_id 


immediate_ messages, im 


restores the immediate printing of messages sent by 
the send_ message command, 


Usage: immediate_ messages 
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indent, ind 
improves the readability of a PL/I source segment by 
indenting it according to a set of standard conventions, 


Usage: indent oldpath { newpath } {—control_args } 


oldpath 
pathname of input PL/I source segment. 


newpath 
pathname of output PL/I source segment. 


control_args 
—brief, —bf 
—comment N, —cm N 
—indent N, —in N 
—lmargin N, —Im N 


initiate, in 
enables users to initiate segments directly, ie., not 
using the normal search rules. 


Usage: initiate path { ref_names } {-control_arg } 


ref_ names 
reference names for the segment. 


control_arg 
—long, —lg 


io_call, io 
performs an operation on a designated I/O switch. 


Usage: io attach switchname modulename { args } 
Usage: io detach switchname 
Usage: io open switchname mode 
Usage: io close switchname 
Usage: io get_line switchname {n} = control_args } 
Usage: io get_, chars switchname n {= control_args 
Usage: io put_chars switchname { string } 
{- control_args } 
Usage: io read_record switchname n {- control_args } 
Usage: io write_record switchname { string } 
{—control_args } 
Usage: io rewrite_record switchname { string } 
{- control_ args } 
Usage: io delete_record switchname 
Usage: io position switchname type 
Usage: io seek_ key switchname key 


By. 


Usage: 
Usage: 
Usage: 
Usage: 
Usage: 
Usage: 
Usage: 
Usage: 
Usage: 


io read_ key switchname 

io read_length switchname 

io control switchname order 

io modes switchname { string } {_brief } 
io find_iocb switchname 

io look_iocb switchname 

io move_attach switchname switchname2 
io destroy_iocb switchname 

io print_iocb switchname 


switchname 
name of the I/O switch. 


module name 
name of I/O module used in attachment. 


args 
any arguments accepted by the 1/0 module 
used. in attachment. 


mode 
stream_input, si keyed_sequential_input, 
stream_ output, so ksqi 
stream_input_output, keyed_sequential_output, . 
sio ksqo 
sequential_input, sqi keyed_ sequential_up- 
sequential_output, date, ksqu 
sqo direct_ input, di 
sequential_input_out- direct_output, do 
put, sqio direct_update, du 
sequential_update, 
squ 
nh 
decimal number. 
string 
any character string. 
type 
bof, —1. set to beginning of file. 
eof, 1 set to end of file. 
fN set forward N records or lines. 
tN set back N records. 
othern number whose interpretation de- 
pends on I/O module being used. 
key 


string of ASCII characters with 
0 < length < 256. 
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order 


one of the orders accepted by the I/O module 
used in the attachment of the 1/O switch. 


control_args 
—brief, —bf 
—lines 
—nl 
—nnl 
—segment path {offset}, —sm path {offset} 
—segment path {length}, —sm path {length } 
—segment path {offset } fiength}, 
—sm path {offset} {length} 


| line_length, ll 


sets the maximum length of a line output to the de- 
vice that a process is connected to through the 
user_ output I/O switch. 


Usage: line_length maxlength 
maxlength 
maximum jength of line. 
link, Ik 


creates a storage system link with a specified name in: 


specified directory pointing to a specified segment or 
directory. 


Usage: link path1] path21...pathin {path2n} 


pathli 


pathname of the segment to which path2i is to 
point. 


path2i 
pathname of the link to be created. 
list, ls 


prints information about entries contained in a 
single directory. 


Usage: list { entrynames } {-control_args } 


entrynames 
names of entries to be listed. 


control_ args 
listed below by function. 


Directory: 
—pathname path, —pn path 
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Entry Type: 
—all, —a 
—branch, —br 
—directory, —dr 
—file, —f 
—link, —Ik 
—multisegment_file, —msf 
—segment, —sm 
Columns: 
—count, —ct 


—date_time_contents_ modified, —dtcm 


—date_time_entry__modified, —dtem 
—date_time_used, —dtu 
—length, —In 
—link_ path, —Ip 
—mode, —md 
—name, —nm 
—record, —rec 
Totals/Header Lines: 
—no_ header, —nhe 
—total, —tt 
Multiple-Name Entries: 
—match 
—primary, —pri 
Entry Order: 
—reverse, —Iv 
—sort XX, —sr XX 


Entry Exclusion: 
—exclude entryname, —ex entryname 
—first N, -ft N 
—from DT, —fm DT 
—to DT 
Output Format: 
—brief, —bf 
—short, —sh 


list_abs_ requests, lar 
prints information/about absentee requests. 


Usage: 


list_abs_requests {—control_args } 
—all, —a 

—long, —lg 

—queue N, —q’N 

—total, —tt 
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list_acl, la 
lists the ACLs of segments, multisegment files, and 
directories. 

Usage: list_acl {path} { User_ids } {-control_args } 


—brief, —bf 
—directory, —dr 
—ring_ brackets, —rb 
—segment, —sm 


list_ daemon requests, Idr 
prints information about dprint and dpunch requests. 

Usage: list_daemon_requests {—control_args } 

—all, —a 

~—long, —ig 

—queue N,—-q N 

—request_type XX, —rqt XX 

—total, —tt 


list_iacl_ dir, lid 
lists some or all of the entries on a directory initial 
ACL in a specified directory. 
Usage: list_iaci_dir { path } { User_ids } 
{- control_args } 
—brief, —bf 
~—ring N, —rg N 


list_iacl_seg, lis 
lists entries on a segment initial ACL in a specified 
directory. 
Usage: list_iacl_seg { path } {User_ids } 
{—control_ args 
—brief, —bf 
—ring N, -rg N 


list_ref_names, Irn 
lists the absolute pathname and reference names 
associated with a segment. 
Usage: list_ref_names paths {-control_args } 
—all, —a 
—brief, —bf 
—fromN —-toN 
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list_resources, Ir 
lists resources that are assigned or attached to the 


calling process by the resource control package (RCP). 


Usage: list_resources {—control_args } 


—assignments, —asm 

—attachments, —atm 
—device XX, —dv XX 
—long, —lg 

—type XX, —tp XX 


login, | 
used to gain access to the system. 
Usage: login Person_id { Project_id } {—control_args } 


Person_id 
user’s personal identifier. 


Project_id 
identification of the user’s project. 


control_args 


~authorizatian XX, —no_preempt, —np 
—auth XX —no_print_off, —npf 
—brief, —of —no_start_up, —ns 
—change_de- —no_ warning, —nw 
fault_auth, —cda —outer_module p, 
—change_de- —om p 
fault_project,—cdp -—print_off, —pf 
—change_pass- —process_ overseer 
word, —cpw path, —po path 
—force —ring N 
—generate_pass- —subsystem path, 
word, —gpw —ss path 
—home_dir path, —terminal_type XX, 
—hd path —t tp XX 
—modes XX 


logout 
terminates a user session. 


Usage: logout {—control_args } 


—brief, —bf 
—hold 
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mail, ml 
sends a message to another user or prints messages 
in a mailbox. 


Usage: (sending) 
ml path Person_idi Project_idl.. 
{ Person_idn } { Project_idn } 
(printing) 
ml { path + = control_arg } 
—brief, —bf 
SENDING 
If path is *, mail responds with “Input:” and 
accepts lines from the terminal until a line consisting 
of a period (.) is typed. 
PRINTING 
If no path argument is given, the contents of the de- 
fault mailbox is printed. 
CREATING A MAILBOX 
A default mailbox is created automatically the first 
time a user types ‘mail’; the detault mailbox is: 


>user_dir_dir>Project_id>Person_id>Person_id.mbx 


MAP 


tells system user has terminal that generates only 
uppercase characters; system then maps each typed 
character to lowercase unless it is preceded by a 
backslash (\). 


Usage: MAP 


memo 
maintains an interactive notebook and reminder list. 


Usage: memo {—control_arg } {optional_args } 
{ memo_text } 


control_args 


—briet, —bf 

—delete, —dl 

—list, —Is 

—off 

—on 

—pathname path, —pn path 
~print, —pr 


38 


optional_args 
memo_ number 
—alarm, —al 
—call 
—date DT, -dt DT 
—invisible, —iv 
~—match XX 
—repeat intvl,; —rp intvl 
—time DT, —tm DT 
memo_ text : 
text of memo being set. 


move 


moves a designated segment or multisegment file (and 
its ACL and all names on the designated file) to a new 
position in the storage system hierarchy. 


Usage: move pathl] {path21}...pathin { path2n} 
{—control_arg 
pathli 
pathname of segment to be moved. 
path2i 
pathname to which pathli is to be moved. 
control_arg 
—brief, —bf 
move_ quota, mq 
moves storage quota between two directories, one 
immediately inferior to (contained in) the other. 
Usage: move_quota path] quota_changel.. 
. pathn quota_ changen 
pathi 
pathname of directory. 
quota_ changei 
number of records to be moved between the 
containing directory quota and the pathi quota. 
new_ proc 


destroys the user’s current process and creates a new 
one, using the control arguments given initially with 
the login command, and the optional control argument 
to the new__proc command itself. 


Usage: new_proc {-control_arg } 
—authorization XX, ~auth XX 
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page_trace, pgt 
prints a recent history of page faults and other system 
events within the calling process. 


Usage: page_trace { count } {—control_arg } 


count 
prints the last count of system events recorded 
for the calling process. 


control_arg 
—long, —lg 
pli 
invokes the PL/I compiler. 
Usage: pli path {—control_args } 


—brief, —bf —profile, —pf 
—brief_ table, —bftb —severityN, —svN 
—check, —ck —source, —Sc 
—debug, —db —symbols, —sb 
—list, —Is —table, —tb 
—map —time, —tm 


—optimize, —ot 


pl1_abs, pa 
submits an absentee request to perform PL/I 
compilations. 
Usage: pll_abs paths {—pll_args } {—dp_args } 
{-abs_ control_args 
pli_abs 
control arguments accepted by the pl! 
command. 
dp_args 
control arguments (except —delete) accepted 
by the dprint command. 


abs_control_args 
—queve N,-qN 
—hold 
—output_file path, -- of path 


print, pr 
prints a specified ASCII segment on the user’s 
terminal. 


Usage: print path { begin } { end } 
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begin 7 = od 
the line number that identifies where printing 
begins. 

end ape e . 
the line number that identifies where printing 
ends. 


print_attach_ table, pat 
prints a list of attached 1/O switches, their attach 
descriptions, and opening mode. 


Usage: print_attach_table { switch_names } 


switch_names 
names of I/O switches. 


print_auth_names, pan . 
prints the names of the sensitivity levels and access 
categories defined for the installation. 


Usage: print_auth_names {—control_ args } 
—all, —a 
—brief, —bf 
—category, —cat 
—level 


print_default_wdir, pdwd . 
prints out the pathname of the current default work- 
ing directory. 


Usage: print_default_wdir 


print__messages, pm . 
prints any interprocess messages that were received 
(and saved in the user’s mailbox) while the user was 
not accepting messages. 


Usage: print_ messages 


print_motd, pmotd . 
prints out changes to the message of the day since the 
last time the command was called. 


Usage:  print_motd 
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print_proc_auth, ppa 
prints the access authorization of the current process 
and current system privileges (if any). 
Usage: print_proc_auth {—control_args | 
—all, —a 
—long, —lg 


print_request_ types, prt 


prints a list of all request types handled by the 1/O 
daemon. 


Usage:  print_request_types {-control_args } 


—access_ name XX, —an XX 
—brief, —bdf 
—gen_type XX, -st XX 


print_search_rules, psr 
prints the search rules currently in use. 
Usage: print_search_rules 


print_wdir, pwd 
prints the pathname of the current working 
directory. 


Usage:  print_wdir 


probe, pb 
provides symbolic, interactive debugging facilities for 
programs compiled with PL/I, FORTRAN, or COBOL. 


The program to be debugged must be compiled with 
the —table control argument. 


Usage: probe { procedure_name } 


procedure_name 
the symbolic name of the form, 


reference_name$offset_name, of an entry toa 
procedure or subroutine. 


REQUESTS 
after a Set a break after a statement. 
before b Set a break before a statement. 
call c] Call an external procedure. 
continue Cc Return from probe. 
execute e _Execute a Multics command. 
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goto g Transfer to a statement. 

halt h Stop the program. 

if (none) Execute commands if condi- 
tion is true. 

let ] Assign a value to a variable. 

mode (none) Turn brief message mode on 
or off. 

pause pa Stop a program once. 

position ps Examine a specified state- 
ment or locate a string in the 
program. 

quit q Return to command level. 

reset r Delete one or more breaks. 

source sc Display source statements, 

stack sk Trace the stack. 

status st Display information about 
breaks. 

step s Advance one statement and 
halt. 

symbol sb Display the attributes of a 
variable. 

use u Examine the block specified. 

value v Display the value of a variable. 

where wh Display the value of probe 
pointers. 

while wl Execute commands while 


condition is true. 


profile 
prints information about the execution of each state- 
ment in PL/I or FORTRAN programs. The — profile 
control argument must have been used when the 
program was compiled. 


Usage: profile paths {—control_args } 


—brief, —bf 
—long, —lg 

—print, —pr 
—reset, —rs 


program _interrupt, pi 
allows a subsystem which establishes a handler for 
program_interrupt to regain control after a QUIT, 
fault, or call out by the use of this command. 


Usage: program_interrupt 
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progress, pg 


executes a specified command line and prints infor- 
mation about how its execution is progressing in 
terms of CPU time, real time, and page faults. 


Usage: progress {—control_arg } { command _line } 


control_arg 
—brief, —bf 
—cput N 
—off 
—on 
—output_switch XX, —os XX 
—realt N 
command _line 
character string created by concatenating all the 
arguments to progress (excluding the first if it 
is a control argument) with blanks between 
them. The string is executed as a command line. 


qedx, qx 
context editor used to create and edit ASCII segments 
in Multics. 

Usage: qedx { path } { optional_args } 

path 
pathname of an ASCII segment from which the 
editor takes its initial instructions. 

optionai_args 
appended, each as a separate line, to the buffer 
named args. 

REQUESTS ; 
Listed below in four categories giving: format, default 
in parentheses, and brief description. For value of 
ADR, see “Addressing” below; regexp, see “Regular 
Expression.” 

INPUT REQUESTS 
These requests enter input mode and must be termi- 
nated with \ f. 


ADRa (.a) append lines after specified 
line. 
ADR1,ADR2c (.,.c) change existing line(s); de- 
lete and replace. 
ADRI C.D insert lines before speci- 
fied line. 
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BASIC EDIT REQUESTS 
ADR1,ADR2d (.,.d) 
ADR1,ADR2p (.,.p) 
ADR= (.=) 

q 
ADRr path ($r path) 


delete line(s). 

print line(s). 

print line number. 

exit from qedx editor: 
append contents of path 
after specified line. 


ADRI JADR2s/regexp/string( , §/tegexp/string/) 


substitute every regexp in 
the line(s) with string. If 
string contains &, & is re- 
placed by regexp. First 
character after s is de- 
limiter; it can be any char- 
acter not in either regexp 
or string. 


ADR1,ADR2w {path}(1,$w) 


/regexp/ 


EXTENDED EDIT REQUESTS 


e <command line> 


write lines into segment 
names path; if path omit- 


ted, default pathname used. 


set the value of ‘*.” to the 
first line following the cur- 
rent line that contains 
regexp and print the line. 


execute command line 
without leaving editor. 


ADRI1 ,ADR2X/regexp/ (1 ,$gX/rege xp/) 


perform operation on lines 
that contain regexp; X 
must be d for delete, p for 
print, or = for print line 
numbers. 


ADR1,ADR2vX/regexp/(1,$vX/rege xp/) 


BUFFER REQUESTS 
b(X) 


ADR1,ADR2m(x)(. , 


perform operation on lines 
that do not contain regexp; 
X must be d for delete, p 
for print, or = for print 
line numbers. 


go to buffer names X. 


-m(X)) 


move line(s) from current 
buffer into buffer names X. 


x give the status of all buffers 


in use. 

ADRn (.n) set the value of “*.” to line 
addressed. 

ADR” (.”’) ignore rest of iine; used for 
comments. 


ADDRESSING 


Most editing requests are preceded by an address speci- 
fying the line or lines in the buffer on which the re- 
quest is to operate. Lines in the buffez can be 
addressed by absolute line number; relative line num- 
ber, ie., relative to the “current” line; and context. 
Current line is denoted by period (.); last line of buffer, 
by dollar sign ($). 


REGULAR EXPRESSION 


The following characters have specialized meanings 

when used in a regular expression. The user can rein- 

voke the last used regular expression by giving a null 

regexp (/ /). 

* signifies any number (or none) of the preceding 

character. 

when used as the first character of a regular expres- 

sion, signifies the character preceding the first 

character on a line. 

$ when used as the last character of a regular expres- 
sion, signifies the character following the last char- 
acter on a line. 


as 


matches any character on a line. 


ESCAPE E SEQUENCES 


\f exit from input mode and terminate the input 
request. 

\c suppress the meaning of the escape sequence or 
special character following it. 

\ b(X) redirect editor stream to read subsequent input 
from buffer X. 

Gr temporarily redirects the input stream to read 
a single line from the user’s terminal. 


ready, rdy 


types out an up-to-date ready message giving the time 
of day as well as the amount of CPU time and page 
faults used since the last ready message was typed. 


Usage: ready 


46 


ready _ off, rdf 


turns off the ready message. 


Usage: tready_off 


ready _on, rdn 
prints a ready message after each command line has 
been processed. 


Usage: ready_on 


release, rl 
releases the stack history that was automatically pre- 
served after a quit signal or unclaimed signal. 

Usage: release {—control_arg } 


—all,—a 


rename, m 
replaces an entry name by a specified new name, with- 
out affecting any other names the entry might have. 


Usage: rename path] namel... pathn namen 


pathi 
old name that is to be replaced. 
namei 
new name that replaces the entryname portion 
of pathi. 
reprint_ error, re 
prints information, from the system condition handler, 
about a condition that has already been handied and 
for which stack history is preserved. 


Usage: reprint_error {—control_args } 
—all, —a 
—brief, —bf 
—depth N, -dhN 
—long, —lg 
resource_ usage, ru 
prints a report of resource consumption for current 
billing period. 
Usage: resource_usage {—control_arg } 
—brief, —bf 
—long, —lg 
—total, —tt 
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run_cobol, rc 


initiates execution of a COBOL run unit in a specified 
“main program.” 


Usage: run_cobol name {—control_args } 


name 
reference name or pathname of the “main 
program” to be initiated. 


control_args 
—cobol_ switch N, —cs N 
—hno_stop_run, —nsr 


runoff, rf 


types out text segments in manuscript form. 
Usage: runoff paths {—control_args } 


control_args 


—ball N, —bI N —page N, —pg N 
—character, —ch — parameter arg, 
—device N, —dv N —pm arg 
—from N, —fm N —pass N 
—hyphenate, —hph —segment, —sm 
—indent N, —in N —stop, —sp 
—no_ pagination, —toN 
—npgn —wait, —wt 
—number, —nb 
CONTROL WORDS 

Conventions to specify arguments of control requests. 

# integer constant 

c character 


ed character pair 
exp expression (either numeric-or string) 


n integer expression 

£ + indicates update by n; if sign not present, set 
ton 

f segment name 

t title of the form ‘part 1’part2’ part3’ 


CONTROL REQUESTS 
If the request has a default, it is in parentheses fol- 
lowing the definition. 


ad right justify text (on) 
ar arabic page numbers (arabic) 
-bp begin new page 
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-br 
.ccc 


cen 


-chcecd.... 


.ds 

ef #t 
eh #t 
eqn 
.&x text 
fht 


fi 
fo #t 
rc 


tt 

«eb xxx 
-2f XXX 
-he #t 
Af f exp 


inén 
la xxx 
lin 
lltn 
-ma +n 
.mp tn 
-ms +n 
-ml tn 
-m2 +n 


m3 tn 
.m4 tn 
na 
nen 


nt 


.of #t 
oh #t 


.op 


break, begin new line 

change special character from % to 
c (%) 

center next n lines (1) 

note “‘c”’ in chars segment as “‘d”’ 
double space (off) 

defines even footer line # 

defines even header line # 

next n lines are equations (1) 

call command processor with “text” 
format of footnote demarcation line 
(underscore) 

fill output lines (on) 

equivalent to: .ef #t, of #t 
controls footnote numbering: 

reset each page, ‘‘f” continuous, 
“u”’ suppress numbering 

delimits footnotes 

“go back” to label xxx 

“go forward” to label xxx 
equivalent to: .ch #t,.oh #t 
segment f.runoff inserted at point of 
request; value of “exp” assigned to 
“Parameter” 

indent left margin n spaces (0) 
define label xxx 

next n lines treated as text (1) 

line length is n (65) 

equivalent to: .ml +n, .m4 +n (4) 
print only every nth page (1) 
multiple space of n lines (1) 

margin above headers set to n (4) 
margin between headers and footers 
set ton (2) 

margin between text and footers set 
to n (2) 

margin below footers set to n (4) 
do not right justify (off) 

need n lines; begin new page if not 
enough remain (1) 

do not fill output lines; print them 
exactly as entered (off) 

defines odd footer line # 

defines odd header line # 

next page number is odd 


seyp?? 
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-pain 
-pin 


-pltn 
td 


ae) 
Tt 

sk n 

spn 

«St sym exp 


8S 
-trcd.... 


.tsn 
LY XXX 
nn 
.ur text 


-wt 


BUILT-IN SYMBOLS 


begin page n 

skip n lines if n remain; otherwise 
skip n on next page before any text 
a) 

page length is n (66) 

read one line of text from the 
user_input I/O switch and process it 
in place of .rd line 

roman numeral page numbers (arabic) 
“return” from this input segment 
skip n lines (1) 

space ni lines (1) 

assign value of “‘exp”’ to variable 
named “‘sym” 

single space (on) 

translate nonbiank character c into d 
on output 

process next input line only if n is not 
zero (1) 

write “xxx” onto error_ output I/O 
switch 

indent next text line n spaces less 
(jeft margin) 

substitute values of variables in 
“text”, and scan line again 

read one line of text from user_input 
1/O switch and discard it 

comment line; ignored 


comment line; ignored, but included in 
chars output segment 


runoff has over 50 internal variables, which are avail- 
able to the user. In addition, the user can set his own 
variables with the .sr control request. See the runoff 
command in the MPM Commands for the list of 


. built-in symbols. 


EXPRESSIONS 


Expressions can be either arithmetic or string and 
consist of numbers and operators in appropriate com- 
binations. The operators and order of precedence are: 


(bit-wise negation), —(unary) 
(remainder) 

(binary) 

(all are comparison operators that 
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<,> yield —1 for true or 0 for false) 
& (bit-wise AND) 
| (bit-wise OR), = (bit-wise 
equivalence) 


runoff_ abs, rfa 


submits an absentee request to process text segments 
using the runoff command. 


Usage: ta paths {—rf_args } {-ear_args } {-dp_args } 
{-abs_ control_ args 


rf_ args 
control arguments accepted by the runoff 
command. 


ear_ args 
control arguments accepted by the 
enter_abs_ request command (except —brief). 
dp_args 
control arguments (except —brief and 
~—truncate) accepted by the dprint command. 


abs_control_ args 


—copy N, —cp N 
—hold 
—queue N, -—q N 


safety_sw_off, ssf 
turns off the safety switch of a segment, directory, or 
multisegment file, thus permitting the segment, direc- 
tory, or multisegment file to be deleted. 


Usage: satety_sw_off { paths } 


safety_sw_on, ssn 
turns on the safety switch of a segment, directory, or 
multisegment file, thus preventing deletion of that seg- 
ment, directory, or multisegment file. 


Usage: satety_sw_on { paths } 


send_message, sm 


sends messages (one or more, always sent one line at a 
time) to a given user on a given project. 


Usage: send_message Person_id Project_id { message } 
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message 
a string up to 132 characters long. If omitted, 
send_ message types “Input :” and accepts 
lines that it sends, one at a time, with each new- 
line character. In this case, input is terminated 
by a line consisting solely of a period. 


set_acl, sa 
manipulates the ACLs of segments, multisegment files, 
and directories. 
Usage: sa path model User_id1... moden { User_idn } 
{—control_args } 
—directory, —dr 
—segment, —sm 


set_ bit_count, sbc 
sets a specified bit count on a specified entry. 


Usage: set_bit_count path] count]... pathn countn 


counti 
is the bit count, in decimal, desired for pathi. 


set_cc 
sets the carriage control transformation fora specified 
FORTRAN formatted file either on or off. 


Usage: set_cc fileN {—control_arg } 
fileN 
name of the FORTRAN file in the range of 
file01 to file99. 
control_arg 
—off 
—on 


set_com_line, scl 
changes the maximum size of expanded command 
lines. 

Usage: set_com_line {size } 


size 
is the new maximum expanded command line 
size. 
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set_iacl_ dir, sid 
adds entries to a directory initial ACL in a specified 
directory or modifies the access mode in an existing 
directory initial ACL entry. , 
Usage: sid path model User_id1... moden { User_idn} 
{—control_ arg } 


—ring N, —rg N 


set_iacl_seg, sis 
adds entries to a segment initial ACL in a specified 
directory or modifies the access mode in an existing 
segment initial ACL entry. 
Usage: sis path model User_id1]... moden { User_idn} 
{_ control_arg } 


—ring N, —rg N 


set_search_rules, ssr 
allows the user to set his dynamic linking search rules 
to suit his individual needs with only minor restric- 
tions. Two types of search rules are permitted: abso- 
lute pathnames of directories to be searched and 
keywords. 


Usage: set_search_rules path 


set_tty, stty 
modifies the terminal type and modes associated with 
terminal I/O. 


Usage: set_tty {-control_args } 
—io_switch XX, —is XX 


—modes XX 

can, “can hndiquit, “hndiquit 

capo, “capo Ifecho, “lfecho 

crecho, “crecho IN 

defauit- pIN 

echoplex, rawi, Arawi 
“echoplex rawo, “rawo 

edited, “edited ted, “red 

erkl, “erkl tabecho, “tabecho 

esc, “esc tabs, “tabs 

fulldpx, vertsp, “vertsp 
afulldpx 


53 


—print 


—reset 

—tabs 

—terminal_type XX, —ttp XX 
1050 TN300, tn300 
2741 TTY 33, tty33 
ARDS, ards TTY 37, tty37 
ASCII, ascii TTY 38, tty38 


CORR2741, corr2741 


sort __seg, ss 
orders the contents of a segment accerding to the 
ASCII collating sequence. 


Usage: sort_seg path {—control_args } 


—all, —2 

—ascending, —asc 
~—biock N, —bk N 
—delimiter XX, —dm XX 
—descending, —dsc 


—field S1L1$2L2...SnLn, 
—f1S1L1S821L2...SnLr 

—replace, —rp 

—segment path, —sm path 

—unique, —uq 


start, sr 
resumes execution of the user’s process from the point 
of interruption after a signal has suspended execution. 


Usage: start {—control_arg } 


—no_ restore, —nr 


status, st 
prints status information about storage system entries, 


Usage: status paths {—control_args } 


Segments, Multisegment Files, and Directories: 

—all, —a 

—author, —at 

—date, —dt 

—device, —dv 

—length, —In 

—mode, —md 

—name, —nm 

—type, —tp 
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Links: 


stop_ 


Usage: 


—all, —a 
—author, —at 
—date, —dt 
—name, —nm 
—type, —tp 


cobol_run, scr 


causes the termination of the current COBOL run 
unit. 


stop_cobol_run { —control_arg } 


—retain_ data, —retd 


terminate, tm 

terminate_segno, tms 

terminate_refname, tmr 

terminate _single_refname, tmsr 
terminates reference names for a segment, unsnaps links 
to the segment, and makes the segment unknown if it 
has no reference names left. 


Usage: 
Usage: 
Usage: 
Usage: 


trace 


terminate paths 
tms seg_ nos 
tmr ref_names 
tmsr. ref_names 


seg__nos 
segment numbers (in octal). 


ref_ names 
reference names. 


a debugging tool that monitors all calls to a specified 
set of external procedures. 


Usage: 


trace {- control_ args } names 


control_args 


~after N ~meter off, —mt off 
—argument N, —meter on, —mt on 
~—ag N —off entryname 
—before N —on entryname 
—brief, —bf : —out 
—depth N,-dhN -—remove entryname, 
—every N, —ev N —rm entryname 
—execute XX, ~—reset entryname, 


—ex XX —rs entryname 


first N, -ft N —return_value off, 
—govern off, —rv off 
—gv off —return_value on, —rv on 
—govern on, —status *, —st * 
—gv on —status entryname, 
—in —st entryname 
—inout —stop_ proc path, —sp path 
—jo switch XX, —subtotal, —stt 
~is XX —template, —tp 
—last N, —It N —total, —tt 
—long, —lg —watch XX, —wh XX 
names 


is a pathname or reference name used in the 
trace table. 


trace_ stack, ts . 
prints machine conditions and stack history of the 


process, most recent first. 
Usage: trace_stack {_control_args } 
—brief, —bf 
—depth N, —dh N 
—long, —lg 


truncate, tc > 
truncates a segment to 4 specified len; 


bit count accordingly. 


Usage: truncate {—control_arg } seg_no length 


gth and resets th 


seg_no 
a pathname or an octal segment number. 


length . 
an octal integer indicating the length of the 


segment in words after truncation. 


control_arg 
—name, —nm 


unassign_ resource, ur 
unassigns a resource that has been assigned to the 


caller’s process. 


Usage: unassign_ resource resource {_control_args } 
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resource 
specifies the name of the resource to be 
unassigned. 
control_args 
—comment XX, —com XX 
—admin, -am 


unlink, ul 
deletes the specified link entry. 
Usage: unlink paths 


vfile_ adjust, vfa 


adjusts a storage system file left in an inconsistent 
state by an interrupted opening. 


Usage: vfile_adjust path {—control_arg } 


—set_be 
—set_nl 
—use_bec { N } 
—use_nl 


vfile_ status, vfs 
prints the apparent type (unstructured, sequential, 


blocked, or indexed) and length of storage system 
files. 


Usage: vtfile_status path 


walk_subtree, ws 
executes a command line in a given directory (called 
the starting node) and in directories inferior to the 
starting node. 


Usage: walk_subtree path command_line {—control_args } 


command _line 
command line to be executed (multiple-word 
command line should be typed as a quoted 
string). 


control_args 
—bottom_up, —bu 
—brief, —bf 
—first N, -ft N 
~—last N, —It N 
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where, wh 
searches for a given reference name using the standard 
search rules and initiates the segment if found. 


Usage: where ref_names 


who 


lists User_ids and other information about current 
users of the system. 


Usage: who {args} {~control_args } 

args 

Person_id 

-Project_id 

Person_id.Project_id * 
control_args 

—absentee, —as 

—brief, —bf 

—long, —lg 

—name, —nm. 

—project, —pj 


963 


tells system user has terminal similar to EBCDIC IBM 
Model 2741 that must be recognized before he can log 
in. 


Usage: 963 


029 


tells system user has terminal similar to Correspond- 
ence code IBM Model 2741 that must be recognized 
before he can log in. 


Usage: 029 
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ACTIVE FUNCTIONS 


The format of each active function in this document is 
based on those found in the MPM Commands. The active 
function name is shown in boldface type followed by a brief 
description of the value this active function returns. In the 
usage line, after the name and description, the following con- 
ventions apply: 


1. For simplicity, four common types of arguments ac- 
cepted by active functions have been abbreviated as 
follows: 


str any character string. 

tf character string that has the value “true” or 
“false”, 

dec character string that represents a decimal 
number. 

dt character string that represents a date and 
time (see also item 5 below). 


2. If an active function accepts more than one of a 
specific argument, “‘_ args” is added to the argument 
name (e.g., tf_ args). 

3. Arguments that must be given in pairs are indicated 
with an “A” and “B” (e.g., strA sirB). 


4. Optional arguments are enclosed in braces (e.g., 
{ strB }. All other arguments are required. 


5. Each dt argument must be in a form acceptable to the 
convert_date_to_binary_ _— subroutine described in 
the Multics Programmers’ Manual Subroutines, Order 
No. AG93. If an optional dt argument is not given, 
information about the current date and time is 
returned. 


6. The term star_name means any pathname that con- 
forms to the star convention. 


The active functions listed below are grouped according 
to operation. An abbreviated description for each active 
function is given in the following pages, arranged in alpha- 
betical rather than operational order. 
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Arithmetic 
ceil 
divide 
floor 
max 
min 
minus 
mod 
plus 
quotient 
times 
trunc 


Character String 
format_line 
index 
index_ set 
length 
search 
string 
substr 
verify 


Date and Time 
date 
date_ time 
day 
day_name 
hour 
long_ date 
minute 
month 


month_name 


time 
year 


Logical 
and 


equal 
exists 
greater 
less 
nequal 
ngreater 
nless 
not 

or 


Segment Name 


directories, dirs 
directory 

entry 

files 

get_ pathname, gpn 
home_ dir 

links 
nondirectories, nondirs 
nonlinks, branches 
nonsegments, nonsegs 
path 

pd 

segments, segs 

strip 

strip_ entry, spe 
suffix 

unique 

wd 


User Parameter 


have_ mail 
system 
user 


Question Asking 


query 
response 


and 
true if all the tf_args = true; otherwise false. 


Usage: { and tf_args ] 


ceil 
smallest integer > dec. 


Usage: [ ceildec ] 


date 
date abbreviation in the form “mm/dd/yy”. 


Usage: [date {dt} ] 


date_ time 
date abbreviation, a time from 0000.0 to 2359.9, a 
time zone abbreviation, and a day of the week 
abbreviation. 


Usage: { date_time {at} ] 


day 
one- or two-digit number of a day of the month, from 
1 to 31. 


Usage: [day {dt} ] 


day_name 
name of a day of the week. 


Usage: { day_name { dt} ] 


directories, dirs 
names (separated by blanks) of all directories matching 
star_ name. 


Usage: [ directories star_name ] 


directory 


directory portion of the absolute pathname of path. 
Usage: [| directory path ] 
divide 

integer part of the value of decA / decB. 


Usage: { divide decA decB ] 
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entry 
entryname portion of the absolute pathname of path. 


Usage: [entry path ] 
equal 

true if strA = strB; otherwise false. 
Usage: { equal strA strB ] 


exists 


checks for the existence of various types of items 
depending on the value of key. 


Usage:  [ exists key str | 


key 

argument 
true if it has been passed an argument str; 
otherwise false. 

branch 
true if a branch with pathname str exists; 
otherwise false. 

directory 
true if a directory with pathname str exists; 
otherwise false. 

entry 
true if an entry with pathname str exists; 
otherwise false. 

file 
true if a segment or multisegment file str 
exists; otherwise false. 

link 
true if a link with pathname str exists; other- 
wise false. 

msf 


true if a multisegment file with pathname 
str exists; otherwise false. 


non_null_ link 
true if a link with pathname str exists and 
points to an existing segment, directory, or 
multisegment file; otherwise false. 


segment 
true if a nondirectory segment with pathname 
str exists; otherwise false. 
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files 


names (separated by blanks) of all segments, direc- 


tories, links, and multisegment files matching a given 
star_ name. 


Usage: [{ files star_name ] 


floor 
largest integer < dec. 


Usage: { floor dec | 


format_line, fl 
formatted character string that is constructed from a 
control string and other optional arguments. 

Usage: [ format_line control_string { args } ] 


control_ string 


isan ioa_ control string that is used to format 
the return value of the active function. 


args 
substituted in the formatted return value, 
according to the ioa_ control string. 


get_pathname, gpn 


absolute pathname of the segment that is designated 
by the reference name or segment number specitied. 


Usage: [ get_pathname {—name } arg ] 


—name 
indicates that arg (which looks like an octal seg- 


ment number) is to be interpreted as a segment 
name. 


arg 
reference name or segment number. 


greater 
true if strA > strB; otherwise false. 


Usage: | greater strA strB ] 


have_ mail 


true if there is mail in the user’s current default mail- 
box or in a specified mailbox; otherwise false. 


Usage: [ have_mail { path } ] 
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home _dir ; 
pathname of the user’s home directory (usually of the 
form >user_dir_dir>Project_id>Person_ id). 


Usage: [ home_dir } 
hour 


one- to two-digit number of an hour of the day, from 
0 to 23. 


Usage: {hour {dt}] 
index 


‘character position in strA where strB begins. If strB 
does not occur in strA, 0 is returned. 


Usage: { index strA strB | 
index_set 


sequence of numbers from 1 through n (where nisa 
decimal integer), separated by spaces. 


Usage: { index_setn] 
length 


character representation of the number of characters 
in str. 


Usage: [length str | 
less 
true if strA < strB; otherwise false. 


Usage: [{ less strA strB | 


links . 
names (separated by blanks) of all links matching a 
given star_name. 


Usage: { links star_name ] 
long_date 


month name, a day number, and a year in the form 
“month, day, year”. 


Usage: { long_date {dt} ] 


max 
numerical maximum of dec_args. 


Usage: | max dec_args | 


64 


min 
numerical minimum of dec_args. 


Usage: | min dec_args ] 


minus 
result of decA — decB. 


Usage: [| minus decA decB ] 


minute 


one- or two-digit number of a minute of the hour, 
from 0 to 59. 


Usage: { minute {dt } | 
mod 
decA modulo decB. 


Usage: { mod decA decB | 


month 


one- or two-digit number of a month of the year, from 


1 to 12. 
Usage: { month {dt} | 


month_name 
name of a month of the year. 


Usage: { month_name {dt} | , 


nequal 

true if decA = decB; otherwise false. 
Usage: | nequal decA decB | 
ngreater 

true if decA > decB; otherwise false. 
Usage: | ngreater decA decB | 
nless 

true if decA < decB; otherwise false. 


Usage: [ nless decA decB | 
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nondirectories, nondirs 


names (separated by blanks) of all segments, links, 
and multisegment files matching a given star_name. 


Usage: [ nondirectories star_name | 


nonlinks, branches 


names (separated by blanks) of ali segments, direc- 
tories, and multisegment files matching a given 
star_ name. 


Usage: [ nonlinks star_name ] 


nonsegments, nonsegs 
names (separated by blanks) of all directories, links, 
and multisegment files matching a given star_ name. 


Usage: { nonsegments star_name ] 


not 


false if str = true; true if str = talse; otherwise an error 
diaynostic, 


Usage: [ notst ] 
or 
true if any if_arg = true; otherwise false. 


Usage: | or tf_args } 


path 


absolute pathname of path_arg (which is a pathname). 


Usage: [ path path_arg ] 


pd 
pathname of the process directory of the process in 
which it is invoked. 

Usage: [pd] 

plus 


sum of dec_args. 


Usage: [ plus dec_args | 
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query 
true if the user’s answer to the question was “‘yes”; 
false if the user’s answer was “no”; otherwise an error 
diagnostic. If the question is more than one word (arg 
contains blanks), it must be enclosed in quotes. 


Usage: [ query arg ] 


quotient 
result of decA / decB. 


Usage: quotient [ decA decB ] 


response 


answer typed by the user in response to the question 
specified by arg. If arg contains blanks, it must be en- 
closed in quotes. 


Usage: [ response arg ] 
arg 
the question to be asked. 
search 
first character position in strA that mects the follow- 
ing test: does any character in strB occur in strA? If 


no character of strB occurs in strA, 0 is returned. 


Usage: | search strA strB } 


segments, segs 
names (separated by blanks) of all segments matching 
a given star_name. 


Usage: { segments star_name | 


string 
single character string. If no str_args are present, a null 
character string is returned. If one or more str_args are 
present, then any quotes in these are doubled when 
str_args are placed in the quoted return string. 


Usage: | string {str_args } ] 
strip 
absolute pathname of the specified entry with the 


last component removed, If str is specified, the last 
component is removed only if it matches str. 


Usage: [strip path {str} ] 
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strip_entry, spe 
entryname portion of the absolute pathname returned 
by the strip active function. If str is specified, the last 
component is removed only if it matches str. 


Usage: { strip_entry path {str} | 


substr ae 
portion of str starting with decA and continuing for 
decB characters (the default for decB is 1). 


Usage: | substr str decA {decB} J 


suffix . 
last component of the entryname portion of the speci- 
fied segment. If that entryname has only one com- 
ponent, it returns the null string. 


Usage: [| suffix path | 


system 
various installation-dependent system parameters 
Usage: [system key | 
key 

company 
per-system parameter company name. 

date _up 
date that the system was brought up, in the 
form “‘“mm/dd/yy”. 

department 
per-system parameter computer center de- 
partment name. 

down _until_date 
date that the system will next be brought up, 
if specified by operator, in the form 
“mm/dd/yy”. 

down_until_time 
time that the system will next be brought up, 
if specified by operator, in the form 
“hhmm.t”. 

ds company 
per-system parameter company name, with 
the characters of the name double spaced. 
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ds_ department 
per-system parameter computer center de- 
partment name, with the characters of the 
name double spaced. 

installation_id 
per-system parameter installation 
identification. 

last_down_ date. 
date that service was last interrupted, 
whether by shutdown or crash. 


last_down_ reason 
reason for the last system service interrup- 
tion, if known. The reason may be: 
shutdown normal system shutdown 


crash system crash (no number 
assigned) 
n number of system cras 


last_ down_ time 
time that service was last interrupted. 
max_ units 
current maximum number of load units, in 
the form “nnn.n’’. 


max _ users 
current maximum number of users. 


n_units 
current number of logged-in load units in- 
cluding daemon and absentee, in the form 
“nnnn’, 


n_users 
current number of logged-in users including 
daemon and absentee. 


next_down_date 
date that system will next be shut down, if 
specified by operator. 

next_down_time 
time that system will next be shut down, if 
specified by operator. 

next_ shift 
next shift number. 
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Teason_ down 
reason for next shutdown, if specified by 
operator, 


shitt 
current shift number. 
shift_change_ date 
date on which current shift number will 
change to next_ shift, 
shift_change_time 
time at which current shift number will 
Change to next_ shift. 
sysid - 
version number of the hardcore system tape 
currently running. 
time_up 


time that system was brought up, in the 
form “hhmm.t”. 


time 
four-digit time of day in the form “hh:mm” where 
00 < hh < 23 and 00< mm <59. 


Usage: { time {dt}] 


times 
result of decA * decB. 


Usage: [| times decA decB ] 


trunc 


largest integer whose absolute value is < absolute value 
of dec. 


Usage: | trunc dec ] 


unique 


unique character string as generated by the 
unique_chars__ subroutine. 


Usage: [| unique | 
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user 
various user parameters. 


Usage: { user key | 
key 


absentee 


true if the user is an absentee user; other- 
wise false. 


absin 
absolute pathname of absentee user’s ab- 
sentee input segment including the absin 
suffix; otherwise a null string. 


absout 
absolute pathname of absentee user’s ab- 
sentee output segment; otherwise a null 
string. 

anonymous 


true if the user is an anonymous user; 
otherwise false. 


auth 
short string for the authorization of the 
user’s process or system_low. 


auth_long 


long string (in quotes) for the authorization 
of the user’s process or “‘system_low”’. 


brief_ bit 
true if the user specified the —brief control 
argument in his login line; otherwise false. 


cpu_ secs 
user’s CPU usage (in seconds) since login, in 
the form “‘sss.t” with leading zeros 
suppressed. 


log__ time 
user connect time (in minutes) since login, 
the form ‘“‘mmm.t”. 


login_date 
date at login time, in the form 
“mm/dd/yy”. 


login_ time 
time of login, in the form “hhmm.t”. 
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max_ auth = 
short string for the max authorization of the 


user’s process or system _low. 
max_auth_long 

long string (in quotes) for the max authori- 

zation of the user’s process or ““system_low’ 
name 

user’s User_id at login time. 


outer_ modulo 
initial outer modulo for the terminal channel. 


preemption _time 
time at which the primary user becomes 
eligible for group preemption, in the form 
“hhmm.t”. 

process_id a 
user’s process identification in octal. 

project 
user’s Project_id. 

protected 
true is user currently a primary user and 
protected from preemption; otherwise false. 

secondary 
true if the user is currently subject to pre- 
emption; otherwise faise. 

term_id oe 
user’s terminal ID code. It is “none” if the 
user’s terminal does not have the answer- 
back feature. 

term_ type 
user’s terminal type. It can have one of the 
following values: 
“Absentee” “CORR2741” “TN 300” 
“Network” “TTY33” “ARDS” 
“1950” ul We es “ASCH” 
9741” “TTY 38” 


first character position in strA that fails the following 
test: does any character in strB occur in strA? If every 
character of strB occurs in strA, 0 is returned, 


[ verify strA strB | 


de 


wd 


pathname of the working directory. 
Usage: [wd] 
year 

two-digit number of a year of the century. 


Usage: { year {dt} ] 


MULTICS ASCII CHARACTER SET 


0 1 2 3 4 5 


000 NUL 

010 BS HT NL VT NP CR 
020 

030 


040 Space 
050 ( 
060 0 
070 8 
100 @ 
110 H 
P 
Xx 


wo* 3 
Ww + 4 
a) 
we 


strwonaA -- 


120 
130 
140 
150 h 
160 p 
170 x 


Kok COO RpOeEY 
NASON we Ww 
AY FORD RO: 

“ 
wes CK CyZmi wm} 


-eftKa 


Unused Characters 
These characters are reserved for future use: 


SOH 001 ACK 006 DC4 024 
STX 002 DLE 020 NAK 025 
ETX 003 DC1 021 SYN 026 
EOT 004 DC2 022 ETB 027 
ENQ 005 DC3 023 CAN 030 
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6 


SO 


Re 


@< Sy Ot AnmvaA: 


EM 
SUB 
ESC 
VS 
GS 
RS 
US 


7 


BEL 
SI 
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